RunFunction Method (string, string, object[], ref object[])

Runs an XJEase function with the specified name from the given device's test device file. The XJEase function is run synchronously i.e. control does not return from this method until the function has completed.

Type: Runner

Namespace: XJTAG.Integration.XJRunner

Syntax

public void RunFunction(string device, string functionName, object[] inputArgs, ref object[] outputArgs)

Parameters

device

Type: string

The name of the device on which to run the function. If there are multiple boards in the project, the device name should be in the form Board.Device.

functionName

Type: string

The name of the XJEase test function to run.

inputArgs

Type: object[]

The input arguments for the function. An arbitrary number of string and integer arguments can be given, corresponding to the parameters for the function to be run.

outputArgs

Type: object[]

The initial values for the output arguments; individual arguments can be initialised as null. This output array is modified by the function that is run and passed back out.

Exceptions

RuntimeException

There was an error running the XJEase code.

System.ArgumentException

The function name was an empty string.

System.ArgumentNullException

Any of the arguments were null.

System.ObjectDisposedException

The Runner has already been disposed.